3D Graphics Programming with QuickDraw 3D 1.5.4

Determining Whether an Error Is Fatal

The Error Manager provides a routine that you can use to determine whether an error is a fatal error.

Q3Error_IsFatalError

You can use the Q3Error_IsFatalError function to determine whether an error is fatal.



 
TQ3Boolean Q3Error_IsFatalError (TQ3Error error);

error: A code that indicates the type of error that has occurred.

DESCRIPTION

The Q3Error_IsFatalError function returns, as its function result, a Boolean value that indicates whether the error value specified by the error parameter is a fatal error (kQ3True ) or is not a fatal error (kQ3False ). You can call Q3Error_IsFatalError from within an error-handling method or after having called Q3Error_Get to get an error directly. If Q3Error_IsFatalError returns kQ3True , you should not call any other QuickDraw 3D routines. QuickDraw 3D executes a long jump when it encounters a fatal error; your application should terminate.

Currently, QuickDraw 3D recognizes these errors as fatal:



 
kQ3ErrorInternalError

kQ3ErrorNoRecovery